home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 16 / tdraw210.zip / THEDRAW.DOC < prev   
Text File  |  1987-03-06  |  72KB  |  3,367 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                               TheDraw Version 2.10 
  26.                          Color Screen Image Text Editor
  27.  
  28.  
  29.  
  30.                               COPYRIGHT (C) 1986,87
  31.                   TheSoft Programming Services and Ian E. Davis
  32.  
  33.              All rights are reserved by TheSoft Programming Services
  34.  
  35.  
  36.  
  37.                     Written in Turbo Pascal on a Tandy 1000.
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                    I N D E X:
  72.  
  73.  
  74.         Introduction ................................................. 1
  75.         Cursor Control ............................................... 2
  76.         Command Summary .............................................. 3
  77.         New Features in Version 2.0 .................................. 4
  78.         New Feautres in Version 2.1 .................................. 6
  79.  
  80.         Command Descriptions: 
  81.           Alt-A: Change Text Color Attributes ........................ 7
  82.           Alt-B: Block Action Commands ............................... 8
  83.           Alt-C: Clear Current Screen ............................... 10
  84.           Alt-D: Set Default Clear Screen Color ..................... 11
  85.           Alt-E: Exchange Edit Screens .............................. 12 
  86.           Alt-F: View Function Key Sets ............................. 13
  87.           Alt-G: Global Commands .................................... 14
  88.           Alt-H: Display Help Information ........................... 16
  89.           Alt-I: Insert a Line ...................................... 17
  90.           Alt-J: Select Animator Mode (toggle) ...................... 18
  91.           Alt-K: Delete a File ...................................... 19
  92.           Alt-L: Load Screen from Disk .............................. 20
  93.           Alt-M: Select Draw Mode (toggle) .......................... 21
  94.           Alt-N: Ruler .............................................. 22
  95.           Alt-O: Change Drive/Sub Directory ......................... 23
  96.           Alt-P: Paint/Fill Commands ................................ 24
  97.           Alt-Q: Redraw Screen (animator mode only) ................. 25
  98.           Alt-R: Restore Current Line ............................... 26
  99.           Alt-S: Save Screen to Disk ................................ 27
  100.           Alt-T: Tab Setup .......................................... 29
  101.           Alt-U: Use Color under Cursor ............................. 30
  102.           Alt-V: View a Screen (not load) ........................... 31
  103.           Alt-W: Edit Character (animator mode only) ................ 32
  104.           Alt-X: Exit TheDraw ....................................... 33
  105.           Alt-Y: Delete Current Line ................................ 34
  106.           Alt-Z: Erase Cursor Character (animator mode only) ........ 35
  107.           Alt-=: Toggle Macro Learning Mode ......................... 36
  108.  
  109.         Alternate Color Change Options:
  110.           Foreground Color Change ................................... 37
  111.           Background Color Change ................................... 38
  112.  
  113.         The Solid Space ............................................. 39
  114.         Programmers Programming Tips ................................ 40
  115.         Revision History ............................................ 42
  116.         The Future .................................................. 44
  117.         Registration ................................................ 45
  118.         TheDraw Upgrade Service ..................................... 46
  119.         Warranty .................................................... 47
  120.         License ..................................................... 48
  121.         Comments .................................................... 49      
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                             I N T R O D U C T I O N:
  138.  
  139.  
  140.         TheDraw  was  written  as an improvement to  AnsiDraw  by  Amrich 
  141.         Enterprises.   Both  programs  provide  similar  operation,  with 
  142.         TheDraw  giving  a much enhanced user  interface.   In  addition, 
  143.         TheDraw  does  not  utilize hardware blanking  as  AnsiDraw  does 
  144.         (You  can verify this by pressing CTRL-C before AnsiDraw displays 
  145.         its opening screen,  and then doing a Dos directory).  There have 
  146.         been  reports that hardware blanking on a system using a Hercules 
  147.         compatible  graphics interface can cause physical  damage.   This 
  148.         makes TheDraw safe for such computer setups.    Lastly,  AnsiDraw 
  149.         apparently fails to operate on newer Tandy 1000's;  TheDraw works 
  150.         fine.    The  latest  version of AnsiDraw (v3.0) no  longer  uses 
  151.         hardware  blanking,  but I have no information on its ability  to 
  152.         work on the newer Tandy machines. 
  153.  
  154.         TheDraw  is designed to create,  store,  and retrieve screens  of 
  155.         ASCII  text,  ANSI compatible color images,  and ANSI  compatible 
  156.         ANIMATION  sequences.   As examples,  these images can be used in 
  157.         batch files or with the RBBS Bulletin Board System.
  158.  
  159.         For any given application,  if one screen of text is insufficient 
  160.         (the program can only handle a 80x23 image) then multiple screens 
  161.         can  be  linked together with the DOS copy append  function  (ie: 
  162.         COPY FILE1.EXT+FILE2.EXT FILE3.EXT).
  163.  
  164.         I have learned that someone is spreading a rumor that TheDraw can 
  165.         cause  physical damage.   This is either some immature person  or 
  166.         someone  who  ran  the program  CHK4BOMB  on  TheDraw.   Chk4Bomb 
  167.         reports that Bios level disk I/O is done.  First of all, Chk4Bomb 
  168.         will  say that about ANY program written in Turbo  Pascal  (MsDos 
  169.         v3.01).   This  is  only  a fluke in the  scanning  algorithm  of 
  170.         Chk4Bomb seeing some sort of harmless text string.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.         TheDraw                                                 Page 1
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                           C U R S O R   C O N T R O L:
  204.  
  205.  
  206.               The cursor can be moved by using the following keys:
  207.  
  208.                  Up Arrow    : Up one line.
  209.                  Down Arrow  : Down one line.
  210.                  Left Arrow  : Left one position.
  211.                  Right Arrow : Right one position.
  212.                  Home        : First column of current line.
  213.                  End         : Last column of current line.
  214.                  PgUp        : First line in current column.
  215.                  PgDn        : Last line in current column.
  216.                  Ctrl-Home   : First Character of current line.
  217.                  Ctrl-End    : Last Character of current line (plus 1). 
  218.                  Ctrl-PgUp   : Upper-left position of screen.
  219.                  Ctrl-PgDn   : Lower-right position of screen.
  220.                  Tab         : Next set Tab position (see Alt-T).
  221.                  Shift-Tab   : Previous set Tab position (see Alt-T). 
  222.                  Enter       : First column of following line.
  223.  
  224.         Naturally, if you are at a border no action will be taken.  If no 
  225.         tab  position follows the current location,  pressing [TAB]  will 
  226.         return you to column one of the current line.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.         TheDraw                                                 Page 2
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                 C O M M A N D S:
  270.  
  271.         TheDraw  provides the following 27 command  functions,  available 
  272.         through ALT-Letter key sequences:
  273.  
  274.                       Alt-A     Change Text Color Attributes
  275.                       Alt-B     Block Action Commands
  276.                       Alt-C     Clear Current Screen
  277.                       Alt-D     Set Default Clear Screen Color
  278.                       Alt-E     Exchange Edit Screens  
  279.                       Alt-F     View Function Key Sets
  280.                       Alt-G     Global Commands  
  281.                       Alt-H     Display Help Information
  282.                       Alt-I     Insert a Line
  283.                       Alt-J     Select Animator Mode (toggle) 
  284.                       Alt-K     Delete a File 
  285.                       Alt-L     Load Screen from Disk
  286.                       Alt-M     Select Draw Mode (toggle) 
  287.                       Alt-N     Ruler  
  288.                       Alt-O     Change Drive/Sub Directory
  289.                       Alt-P     Paint/Fill Commands 
  290.                       Alt-Q     Redraw Screen (animator)
  291.                       Alt-R     Restore Current Line
  292.                       Alt-S     Save Screen to Disk
  293.                       Alt-T     Tab Setup
  294.                       Alt-U     Use Colors under Cursor  
  295.                       Alt-V     View a Screen (not load)
  296.                       Alt-W     Edit Character (animator) 
  297.                       Alt-X     Exit TheDraw 
  298.                       Alt-Y     Delete Current Line
  299.                       Alt-Z     Erase Cursor Character (animator)  
  300.                       Alt-=     Toggle Macro Learning Mode
  301.                                 (registered version only). 
  302.  
  303.         Additional commands are:
  304.  
  305.               Ctrl-Up Arrow     Increment Foreground Color 
  306.             Ctrl-Down Arrow     Decrement Foreground Color 
  307.             Ctrl-Left Arrow     Increment Background Color
  308.            Ctrl-Right Arrow     Decrement Background Color
  309.  
  310.                 Shift-Space     Put a "Solid" space on the Screen.
  311.  
  312.  
  313.  
  314.         On the following pages are explanations of each of the above.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.         TheDraw                                                 Page 3
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                              N E W   F E A T U R E S
  337.                                  
  338.  
  339.         If you didn't notice up above,  TheDraw has received a major  new 
  340.         ability.   The  ability to animate those wonderful ANSI  drawings 
  341.         you  devised,  to add a little more "color" to  them.   Animation 
  342.         basically  is the apparent movement of objects on the screen from 
  343.         one spot to another.  
  344.  
  345.         I  say apparent since no actual movement takes  place,  only  the 
  346.         overwriting of a new location with a duplicate of  another.   For 
  347.         instance,  suppose you put a smiley face on the screen.   To make 
  348.         it "move" to the right, first you would put a space (or something 
  349.         else)  over the smiley face character then put a new smiley  face 
  350.         to the right of the old spot.  Repeat that over and over, and the 
  351.         smiley face will appear to move across the screen.  Fun stuff!
  352.  
  353.         To  support  this  new function TheDraw operates  in  two  modes;  
  354.         Normal  and Animator.   Normal mode operates like TheDraw  always 
  355.         has, with a few enhancements (such as line drawing).  
  356.  
  357.         Animator   mode   supports   the  "sequencing"   of   characters.   
  358.         Sequencing  simply  means storing each character you type  as  an 
  359.         entry  in  a list.   Each entry stores  the  character,  and  the 
  360.         location  it  appears on the screen.    You can have up  to  5000 
  361.         characters in the list,  which is enough to completely redraw the 
  362.         screen almost three times.
  363.  
  364.         Sequencing also allows you to put multiple characters at the same 
  365.         spot  on the screen (since each character is a simple addition to 
  366.         the  list).   There  is  no direct  overwrite  of  characters  in 
  367.         Animator mode as there is in Normal mode.  You must use a special 
  368.  
  369.         command  to  edit characters (Alt-W) since anything you put  over 
  370.         another character adds to the list, not replacing whats there.
  371.  
  372.         That  is the major difference between the two modes.   Normal  is 
  373.         simply a piece of paper, which you can draw on, and easily change 
  374.         (akin  to  a  limited  word  processor).   Animator  mode  stores 
  375.         EVERYTHING you type,  and special commands must be used to delete 
  376.         and overwrite characters.
  377.  
  378.         Because  of  the nature of the  animation  sequence,  differences 
  379.         occur  between  how  certain  commands work in  Normal  mode  and 
  380.         Animator mode.  All command descriptions in this text are written 
  381.         with Normal mode in mind.  Where there are differences, a note at 
  382.         the bottom of the command describes the changes in Animator mode.
  383.  
  384.         Animation isn't the only new feature added to  TheDraw.   Another 
  385.         is  the ability to "draw" lines using the keys found in  function 
  386.         key  sets 1 through 4.   When in draw mode (indicated by the word 
  387.         Draw  at  the bottom of the screen),  moving the cursor  via  the 
  388.  
  389.  
  390.  
  391.         TheDraw                                                 Page 4
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                         N E W   F E A T U R E S  (cont):
  402.  
  403.  
  404.         four  arrow  keys will produce a line  in  that  direction.   The 
  405.         program  can  handle any situation,  even if you mix line  types.  
  406.         See Alt-M for more details.  
  407.  
  408.         Another  interesting addition in the ability to copy/move a block 
  409.         of text UNDER other text.   Previously, TheDraw could only move a 
  410.         block  over  other  things.   A file called  DEMO.BIN  should  be 
  411.         present to better show this new facility.   When moving the block 
  412.         under something else,  it will show through any space  character.  
  413.         To  complement this new option,  a "solid" non-transparent  space 
  414.         character was added (available using Shift-Space).
  415.  
  416.         Looking  at the extension to DEMO.BIN,  you may be wondering what 
  417.         the  BIN  stand for.   It stands for a Binary file,  which  is  a 
  418.         simple memory dump of the TheDraw edit screen.   Binary files are 
  419.         VERY useful for files edited often since they load and save  very 
  420.         quickly.   In  addition  to binary files,  TheDraw  now  supports 
  421.         Assembler,  BSave  (for users of Basic),  and Pascal  (for  users 
  422.         of...).   Of  course,  the  original  two save methods are  still 
  423.         available  and TheDraw is upwardly compatible with any file  made 
  424.         by earlier versions.
  425.  
  426.         Available  in  the registered version of TheDraw is a  Macro  Key 
  427.         ability.  TheDraw now supports ten 255 character macro sequences.  
  428.         To teach TheDraw a sequence you merely type Alt-=,  the macro key 
  429.         you wish to program, and start typing.  When you are done, typing 
  430.         Alt-=  will save the creation.   Also,  attempting to use another 
  431.         macro  will save it.   The second macro you specified will be  in 
  432.         effect chained to the end of the original one.  
  433.  
  434.            ie:  Lets say you are programming sequence 5, and type Alt-6 
  435.            (for sequence 6).  From now on, whenever you type Alt-5, its 
  436.            contents  will  be  output then TheDraw  will  automatically 
  437.            output  what is in Alt-6.    You can also have a macro  call 
  438.            itself,  creating an endless loop situation.   Typing  [ESC] 
  439.            will break out of it however.  You might use an endless loop 
  440.            to  fill a block with something,  although the new additions 
  441.            to the block commands will do it much faster.
  442.  
  443.         Registered  users  will find TheDraw much easier to  learn  also, 
  444.         since it now includes pop-up help screens.   The help information 
  445.         is  specific to the area of the program you're in and is  brought 
  446.         up by simply pressing Alt-H anywhere.
  447.          
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.         TheDraw                                                 Page 5
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                         N E W   F E A T U R E S  (cont):
  468.  
  469.  
  470.         A couple of other new options are worth mentioning.   TheDraw now 
  471.         supports  Global operations on the screen (global color  changes, 
  472.         screen moving,  etc...), and screen Painting.  Painting can be of 
  473.         either  just color attributes,  characters,  or both  (never  say 
  474.         TheDraw doesn't give a choice).  
  475.  
  476.  
  477.         NEW IN VERSION 2.10...
  478.  
  479.         TheDraw v2.10 has received some new features.  Monochrome screens 
  480.         are now supported, and a incompatibility problem with the Ctrl-Up 
  481.         and  Ctrl-Down foreground color change keys is fixed.   IBM  PC's 
  482.         and  certain  "exact" clones have Bios errors that prevent  those 
  483.         keys  being  recognized.   TheDraw has a  new  pre-Bios  keyboard 
  484.         driver that cures the problem.
  485.  
  486.         A  setup program is included that allows users to "program" those 
  487.         two keys to TheDraw.   TheDraw comes configured for both a IBM PC 
  488.         and  Tandy  1000.   To see if you need  the  setup  utility,  run 
  489.         TheDraw.   Next try to use the Ctrl-Up/Down keys.   If they don't 
  490.         appear  to work then run the Setup utility and follow the  simple 
  491.         on-screen directions.
  492.  
  493.         Other new features are text operations (box  drawing,  outlining, 
  494.         left/center/right justification,  etc...) and Ansi file slowdown.  
  495.         Ansi file slowdown basically makes Ansi files that display veerry 
  496.         slowly (see Alt-S).  
  497.  
  498.         Lastly, most prompts in TheDraw have been revamped to be clearer, 
  499.         and the fill screen operations are now consistent.
  500.  
  501.         Enjoy!!!
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.         TheDraw                                                 Page 6
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                        Alt-A: Change Text Color Attributes
  534.  
  535.  
  536.         This  function  allows  you  to change the colors  text  will  be    
  537.         displayed  with.  The  current settings are  represented  in  the 
  538.         status  line  with  the word "Color".   You can select  from  the 
  539.         following foreground colors:
  540.  
  541.                     0  Black                  8  Dark Gray
  542.                     1  Blue                   9  Light Blue
  543.                     2  Green                 10  Light Green
  544.                     3  Cyan                  11  Light Cyan
  545.                     4  Red                   12  Light Red
  546.                     5  Magenta               13  Light Magenta
  547.                     6  Brown                 14  Yellow
  548.                     7  Light Gray            15  White
  549.  
  550.         Characters  can  be made to blink by selecting  colors  from  the 
  551.         range 16 through 31. These match the above listed colors exactly, 
  552.         except they blink.
  553.  
  554.         Background  colors  can be any of the first eight (0  through  7) 
  555.         colors  listed.   There  are no background colors available  that 
  556.         allow  blinking.  
  557.  
  558.         A  current  setting for either foreground or  background  can  be 
  559.         maintained  by simply pressing <ENTER> at the appropriate  prompt 
  560.         without any number entry.
  561.  
  562.         You  can also change the colors by using the arrow keys.   The Up 
  563.         and  Right arrow keys increase the color with the Down  and  Left 
  564.         decreasing  the color.   Using the arrows also updates the  color 
  565.         example  in the middle of the screen,  so you can see what you'll 
  566.         get before exiting.
  567.  
  568.         Note:  It  is  possible to change the colors without  using  this 
  569.         option.   See Ctrl-Arrow Key commands below.   Monochrome  screen 
  570.         users will find background colors useless except for a background 
  571.         color of 7 and a foreground color of 0 or 16 (black).
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.         TheDraw                                                 Page 7
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                           Alt-B: Block Action Commands
  600.                             
  601.  
  602.         The  block  action commands are one of the more useful  utilities 
  603.         TheDraw  offers.   It  allows  you  to change  a  block  (from  1 
  604.         character  to the entire screen) to the current color attributes, 
  605.         copy or move a block to another position, erase a block, delete a 
  606.         block,  save  a  block as a mini-image,  or  load/merge  part  of 
  607.         another image into the current one.
  608.  
  609.         To  use  any  of  the above commands,  first the  block  must  be 
  610.         defined.  This is done immediately after typing Alt-B.  Go to the 
  611.         upper-left corner of  the wanted block and press  [SPACE].   Then 
  612.         move  to  the lower-right corner and press  [SPACE]  again.   The 
  613.         current  block  will  have all attributes reversed  to   make  it 
  614.         obvious.   If  you  move  above or left of the  upper-left  block  
  615.         corner  (once defined),  no block will be  shown  inverted. 
  616.  
  617.         Upon  pressing [SPACE] the second time you will be presented with 
  618.         the available options:
  619.             
  620.            [C]opy  allows  you  to copy the defined block  to  another  
  621.            position.  Use  the arrow keys to move the block.  You  can 
  622.            [S]tamp extra copies,  [E]xchange the screens (thus copying 
  623.            an area of one screen into the other),  and toggle movement 
  624.            [U]nder  all  characters  (only seeing  the  block  through 
  625.            spaces).   Press  [ENTER]  once  satisfied  with  the   new 
  626.            position.
  627.  
  628.  
  629.            [M]ove  operates identically to [C]opy except the  original 
  630.            position is erased (see following option).
  631.  
  632.  
  633.            [F]ill  gives  you  several additional  options.   All  are 
  634.            related to filling the block with  something.   
  635.  
  636.               [A]ttribute  Change all attributes in the block to the 
  637.                            current ones.
  638.               [F]ore       Change  only the foreground attributes to 
  639.                            the current setting.  
  640.               [B]ack       Similar  to  [F]ore  except  changes  the 
  641.                            background  attributes instead.
  642.               [U]se        Similar  to  [A]ttribute except  it  uses  
  643.                            the attributes under the cursor when  you 
  644.                            first pressed Alt-B.  
  645.               [C]haracter  Prompts for a symbol, and then fills  the 
  646.                            block  with  that  symbol,   leaving  the 
  647.                            attributes  unchanged.
  648.               [B]oth       Combines [A]ttribute and [C]haracter.
  649.  
  650.            These  changes to the fill option hopefully are clearer and 
  651.            more usable than those in previous versions of TheDraw.
  652.  
  653.  
  654.  
  655.         TheDraw                                                 Page 8
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.                       Alt-B: Block Action Commands (cont):
  666.  
  667.  
  668.            [T]ext  allows simple operations to be done on text  within 
  669.            the block.  
  670.                             
  671.               [B]ox        Draws  a  box  around the  edges  of  the 
  672.                            defined block area.
  673.               [O]utline    Similar  to  Box,   except  this  command 
  674.                            examines the text within the block.   The 
  675.                            block will be expanded to accommodate any 
  676.                            words not fully contained by the original  
  677.                            block.
  678.               [C]enter     Text contained in the original block will 
  679.                            be centered within the block area.
  680.               [L]eft       Text  contained in the original block  is 
  681.                            left justified.
  682.               [R]ight      Any text in the block is right justified.  
  683.  
  684.            These  additions should be helpful in making menu  displays 
  685.            or short letters etc... 
  686.  
  687.            [D]elete does what is implied.  All characters to the right 
  688.            of the block are shifted over,  with the area they occupied 
  689.            changed  to  spaces and the attributes set to  the  current 
  690.            default background and currently defined foreground color.
  691.  
  692.            [E]rase is similar to  Delete, except the area to the right
  693.            of the block is not shifted.   The block itself is  cleared 
  694.            (as described above).
  695.  
  696.            [S]ave  operates  identically to the  save  screen  command 
  697.            except only the defined block is output (see Alt-S).
  698.  
  699.            [L]oad  allows you to import data from another image (saved 
  700.            on disk). The current image is stored, and you are prompted 
  701.            for  the import filename (this operates just  like  Alt-L).  
  702.            The  new  image  is loaded onto the screen and  a  inverted 
  703.            block of the size defined appears in the upper-left  corner 
  704.            of the screen.  Move this block (using the arrows) over the 
  705.            wanted part of the screen and press [ENTER].   That portion 
  706.            will then appear in the position of the original block.
  707.  
  708.            [R]escan  is available in animator mode only.   It operates 
  709.            just like the ALT-J animator rescan option, except only the 
  710.            screen  in  the block is rescaned.   The defined  block  is 
  711.            first erased from the animation sequence, then the contents 
  712.            of the screen are scanned and added onto the sequence.
  713.  
  714.  
  715.         Animation  Notes:    The  [L]oad  and  [S]ave  options  are   not 
  716.         available.   The  screen [E]xchange option is not available under 
  717.         the move/copy block commands.
  718.  
  719.  
  720.  
  721.         TheDraw                                                 Page 9
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                            Alt-C: Clear Current Screen
  732.  
  733.  
  734.         This  should be a fairly obvious option.   You are first prompted 
  735.         to verify the command.   If changes have been made to the current 
  736.         image,  you are then asked if you want to save the current image.  
  737.         After that, the screen is cleared with the color specified in the 
  738.         following ALT-D command.
  739.  
  740.  
  741.  
  742.         Animation Notes:    All sequences are erased.   The default color 
  743.         is  NOT  used  to clear the screen,  it is cleared with  a  black 
  744.         background using the currently defined foreground color. 
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.         TheDraw                                                 Page 10
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.                        Alt-D: Set Default Background Color
  798.  
  799.  
  800.         The  default  background is used to 'paint' the entire  screen  a 
  801.         given color upon invoking the ALT-C command.   This color is also 
  802.         used  in various block action commands.   Any block command which 
  803.         moves or erases text will paint the area cleared with this color.  
  804.         Some  commands are,  Move,  Delete,  Erase,  Text  justification, 
  805.         etc...
  806.  
  807.         The  same restrictions of colors apply here as to the  background 
  808.         colors available in Alt-A.
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.         TheDraw                                                 Page 11
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.                           Alt-E: Exchange Edit Screens
  864.  
  865.  
  866.         TheDraw  supports  the  use of two edit screens instead  of  one.  
  867.         This   allows  you  to  load  two  screens   simultaneously   and 
  868.         copy/exchange  different  parts from one to the other (using  the 
  869.         block action commands).   When you are in the exchange screen,  a 
  870.         'Ex' will appear approximately in the center of the bottom  line.                                                 
  871.          
  872.  
  873.  
  874.         Animation Notes:    This command is not available.
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.         TheDraw                                                 Page 12
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.                           Alt-F: View Function Key Sets
  930.  
  931.  
  932.         This  displays  on the screen all 10 sets  of  available  special  
  933.         characters.  These  character sets can be selected in the  editor 
  934.         mode by using ALT and pressing a function key 1 to 10. ie:
  935.  
  936.                             ALT-F1   Selects set #1.
  937.                             ALT-F10  Selects set #10.
  938.  
  939.  
  940.         (The Ctrl and Shift keys used in previous versions are no longer
  941.          supported by TheDraw).
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.         TheDraw                                                 Page 13
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.                              Alt-G: Global Commands
  996.  
  997.  
  998.         Global  commands allow quick and dirty changes to the  attributes 
  999.         of all characters on the screen.   Also, you can copy the current 
  1000.         screen into the exchange screen and can "move" the screen around.
  1001.  
  1002.         Upon  pressing  Alt-G you are shown the following options:
  1003.  
  1004.            [C]opy  simply copies the current screen into the  exchange 
  1005.            screen,  or  if you're already in the exchange screen  into 
  1006.            the normal screen.
  1007.          
  1008.            [M]ove  allows you to move the screen  around.   You  could 
  1009.            duplicate  this  using the block commands,  but this  is  a 
  1010.            faster method.   Use the arrows to rotate the screen around 
  1011.            and press [ENTER] when you like where it is.
  1012.  
  1013.            [F]ill  gives  you  several additional  options.   All  are 
  1014.            related to filling the entire screen with  something.   
  1015.  
  1016.               [A]ttribute  Changes  all attributes on the screen  to 
  1017.                            the current ones.
  1018.               [F]ore       Changes only the foreground attributes to 
  1019.                            the current setting.  
  1020.               [B]ack       Similar  to  [F]ore  except  changes  the 
  1021.                            background  attributes instead.
  1022.               [U]se        Similar  to  [A]ttribute except  it  uses  
  1023.                            the attributes under the cursor when  you 
  1024.                            first pressed ALT-G.
  1025.               [C]haracter  Prompts for a symbol, and then fills  the 
  1026.                            screen  with  that  symbol,  leaving  the 
  1027.                            attributes  unchanged.
  1028.               [B]oth       Combines [A]ttribute and [C]haracter.
  1029.  
  1030.            These  changes to the global fill attributes  options  make 
  1031.            them compatible with the block action fill commands.   This 
  1032.            will hopefully make TheDraw easier to learn.
  1033.  
  1034.            [T]ext  performs allows various operations to be done  upon 
  1035.            the  entire screen.   The options are identical to those in 
  1036.            the block action Text commands.
  1037.  
  1038.               [B]ox        Draws  a  box around the  border  of  the 
  1039.                            screen.
  1040.               [O]utline    Similar to Box, except this command looks 
  1041.                            at the text on the screen.    Any text on 
  1042.                            a screen border will prevent a line  from 
  1043.                            being drawn.
  1044.               [C]enter     Any text on the screen will be centered.
  1045.               [L]eft       Any text on the screen is left justified.
  1046.               [R]ight      Similar to above, but right justifies.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.         TheDraw                                                 Page 14
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.                          Alt-G: Global Commands (cont):
  1062.  
  1063.  
  1064.         Animation Notes: The [C]opy and [M]ove commands aren't available.  
  1065.         All  other  commands operate normally,  except they  only  change 
  1066.         those characters that are in the animation sequence. 
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.         TheDraw                                                 Page 15
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.                          Alt-H: Display Help Information
  1128.  
  1129.  
  1130.         This  displays a couple of short help screens briefly  describing 
  1131.         these command options.
  1132.  
  1133.         Note:  The registered version of TheDraw now supports pop-up help 
  1134.         in the ENTIRE program.   By typing Alt-H wherever you are  stuck, 
  1135.         you  will be displayed function specific help.    Try it,  you'll 
  1136.         like it!
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.         TheDraw                                                 Page 16
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.                               Alt-I: Insert a Line
  1194.  
  1195.  
  1196.         Inserts  a  line at the current position.   The current line  and 
  1197.         everything  below it is shifted down.   The bottom line is  lost.  
  1198.         This command is not reversible, so use it carefully.
  1199.  
  1200.         (Used to be Alt-N in previous versions of TheDraw).
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.         TheDraw                                                 Page 17
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.                            Alt-J: Select Animator Mode
  1260.  
  1261.  
  1262.         This  is in effect two functions.   When toggling from normal  to 
  1263.         animator modes,  you are prompted as to how TheDraw should  enter 
  1264.         the contents of the screen into the animation sequence.   You can 
  1265.         control the method of scanning with the following options:
  1266.  
  1267.            [T]op.  Scans from the upper-left to lower-right corners of 
  1268.            the screen, going across the screen. 
  1269.  
  1270.            [B]ottom.   Does exactly the opposite to [T]op by  scanning 
  1271.            from the lower-right corner to the upper-left corners.
  1272.  
  1273.            [L]eft.  Similar to the [T]op option, except it scans going 
  1274.            down  the  screen  (in vertical  line).   This  option  can 
  1275.            produce a really interesting effect.
  1276.  
  1277.            [R]ight.   Exact  opposite  of [L]eft,  scanning  from  the 
  1278.            lower-right corner to the upper-left,  going Up the screen.  
  1279.            This option produces even odder effects.       
  1280.  
  1281.            [S]cramble.   This is definitely a unique feature you won't 
  1282.            find  anywhere  else.   This command scans in a  completely 
  1283.            random  order.   Makes for either impressive or real  funky 
  1284.            displays.
  1285.  
  1286.         Animation  mode is indicated by the letters 'An' appearing in the 
  1287.         middle of the bottom line,  and a [0000,5000] structure appearing 
  1288.         on  the  line  above.   The  first  number  tells  you  how  many 
  1289.         characters are entered, and the second how much space is left.  
  1290.  
  1291.  
  1292.         If  you select the ALT-J function FROM animation  mode,  you  are 
  1293.         given these three options instead:
  1294.  
  1295.           [N]ormal  will  prompt you to verify the  command,  and  then 
  1296.           converts the screen into normal Ansi.  All animation is lost.
  1297.  
  1298.           [R]escan  will simply rescan the screen as  specified  above.  
  1299.           Once you use this command, any previous sequence is lost.
  1300.  
  1301.           [M]ovement   toggles  whether  or  not  TheDraw  stores   the 
  1302.           movements  of the cursor in addition to simply what you type. 
  1303.           TheDraw  will remember ANYTHING you type or anywhere you move 
  1304.           if this option is on.  You can tell you are in movement store 
  1305.           mode if the 'An' indicator is flashing.  Also, of course, the 
  1306.           animation entry count will change every time you move.
  1307.  
  1308.         Remember,  these options will only appear when you are ALREADY in 
  1309.         the animator mode.
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.         TheDraw                                                 Page 18
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.                               Alt-K: Delete a File
  1326.  
  1327.  
  1328.         This  option  allows you to free up some disk space if  the  need 
  1329.         arises.   It  displays  the current directory so you  can  easily 
  1330.         identify  those files which you don't want.  Simply type  in  the 
  1331.         appropriate  filename and press <enter>.   TheDraw then checks to 
  1332.         see if the file exists.   If it does, you are asked if you really 
  1333.         want  to delete the file.   This is your last chance  before  you 
  1334.         delete something you might regret later.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.         TheDraw                                                 Page 19
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.                           Alt-L: Load Screen from Disk
  1392.  
  1393.  
  1394.         This  allows you to load any ANSI color compatible,  ASCII  text, 
  1395.         Binary,  or BSave file.  The ANSI.SYS driver must be installed to 
  1396.         load  a  ANSI  color  image.   This  can  be  done  by  adding  a 
  1397.         'DEVICE=ANSI.SYS'  statement to your CONFIG.SYS file.  If you  do 
  1398.         not  have  a CONFIG.SYS file,  you can create one by  typing  the 
  1399.         following:
  1400.  
  1401.                            COPY CON CONFIG.SYS<enter>
  1402.                            DEVICE=ANSI.SYS<enter>
  1403.                            ^Z<enter>
  1404.  
  1405.         If you have a CONFIG.SYS file, append the sequence with:
  1406.  
  1407.                            EDLIN CONFIG.SYS<enter>
  1408.                            #I<enter>
  1409.                            DEVICE=ANSI.SYS<enter>
  1410.                            ^Z<enter>
  1411.                            E<enter>
  1412.  
  1413.  
  1414.         If the current screen image has not been saved,  you are prompted 
  1415.         before  the load continues.   The current directory is  displayed 
  1416.         for  convenience.  Simply  type in the appropriate  filename  and 
  1417.         press  [ENTER].   The file extension ".ANS" is assumed if none is 
  1418.         specified.   Binary  files can only be loaded if they have ".BIN" 
  1419.         as a file extension.   Similarly, a BSave file must have a ".BSV" 
  1420.         extension.   You  may  specify  a file without  an  extension  by 
  1421.         placing  a  period  as the last character of  the  filename  (ie: 
  1422.         TESTFILE.  ).   Assembler  and Pascal files can not be  reloaded, 
  1423.         except  as  Ascii text,  so keep a binary copy of  those  screens 
  1424.         safely somewhere.
  1425.  
  1426.         If the file contains more than 23 lines of text,  only the  first 
  1427.         23 are loaded.
  1428.  
  1429.         TheDraw automatically determines if a Ansi screen is an  animator 
  1430.         sequence by the following process:   If the cursor suddenly moves 
  1431.         to  a place it normally would never go,  it is an animator  file.  
  1432.         Extremely complex algorithm huh?
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.         TheDraw                                                 Page 20
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.                              Alt-M: Select Draw Mode
  1458.  
  1459.  
  1460.         TheDraw  now  allows you to "draw" lines very easily,  using  the 
  1461.         characters  normally available with the function  keys.   TheDraw 
  1462.         "draws" using the current function-key set of lines.   If you  do 
  1463.         not  have a function-key set with lines selected,  the first  set 
  1464.         (single  lines)  is  used.   Draw mode is indicated by  the  word 
  1465.         "Draw" at the bottom of the screen.
  1466.  
  1467.         All commands operate normally, and typed characters still appear.  
  1468.         The only change is that using the arrow keys makes a line  appear 
  1469.         in the direction moved.  Fun stuff!     
  1470.  
  1471.         Note:  This  command used to be block action commands in  earlier 
  1472.         versions of TheDraw (see Alt-B).  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.         TheDraw                                                 Page 21
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.                                   Alt-N: Ruler
  1524.  
  1525.  
  1526.         Guess what this one does.   In case you have no idea,  cross bars 
  1527.         appear intersecting where the cursor currently is located.   Move 
  1528.         the ruler using the arrow keys.   Pressing [ENTER] locks the  new 
  1529.         location in place.  Pressing [ESC] returns you to where you were.
  1530.  
  1531.         Use this command for lining up various lines of text or figures.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.         TheDraw                                                 Page 22
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.                         Alt-O: Change Drive/Sub Directory
  1590.                                       
  1591.  
  1592.         This  command  requires the use of DOS 2.0 or higher to  operate, 
  1593.         and  should  be appealing to those hard drive  users  out  there.  
  1594.         This option allows you to change to a different directory if your 
  1595.         need  requires  it.   This  is the only way you  can  change  the 
  1596.         directory  displayed  in the Load or View Screen  commands.   All 
  1597.         sub-dirs in the current directory are displayed for you,  but you 
  1598.         are in no way restricted to using just those.   You may enter any 
  1599.         valid  CHDIR  (or  CD) command (I am not  going  to  explain  the 
  1600.         details of sub-directories.  Refer to your Dos manual for that).
  1601.  
  1602.         This command,  unlike the CHDIR of Dos,  allows you to change the 
  1603.         current drive.  For example, if you were on drive C: in a sub-dir 
  1604.         called 'GAMES', you could switch to drive D: sub-dir 'UTILITY' by 
  1605.         entering  "D:\UTILITY".   You could then get back to the  'GAMES' 
  1606.         directory by simply entering "C:" (no backslash).
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.         TheDraw                                                 Page 23
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.                            Alt-P:  Paint/Fill Commands
  1656.  
  1657.  
  1658.         Never say a computers job is never done.   You can now fill boxes 
  1659.         and objects with just the attributes, just the character, or both 
  1660.         attributes and character that are under the cursor.   Objects are 
  1661.         defined  as any shape made using the function key line  sets,  or 
  1662.         the draw mode.  
  1663.  
  1664.            [A]ttribute  changes the all attributes (not characters) in 
  1665.            the object to those under the cursor. 
  1666.  
  1667.            [C]haracter changes all the characters (not attributes)  in 
  1668.            the object to the one under the cursor.
  1669.  
  1670.            [B]oth  changes  both the attributes and characters of  all 
  1671.            locations in the object to those under the cursor.
  1672.  
  1673.         Painting  has been made significantly faster,  and the  algorithm 
  1674.         now works in a more logical fashion.  
  1675.  
  1676.  
  1677.         Animation Notes:  If using the Character, or Both option then ANY 
  1678.         character  painted  is  added to  the  animation  sequence.   Any 
  1679.         previous characters in the object are not changed.  The Attribute 
  1680.         function  only changes the attributes of characters currently  in 
  1681.         the animation sequence, with no new characters added. 
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.         TheDraw                                                 Page 24
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.                               Alt-Q: Redraw Screen
  1722.  
  1723.  
  1724.         This  is an animator mode ONLY command.   It simply  redraws  the 
  1725.         animation sequence on the screen.   You can adjust the speed from 
  1726.         0  (fastest) to 255 (crawl).   A value of about 50 is generally a 
  1727.         good speed to view at.   Be warned that 255 literally is a  crawl 
  1728.         speed, displaying only about two characters per second.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.         TheDraw                                                 Page 25
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.                            Alt-R: Restore Current Line
  1788.  
  1789.  
  1790.         This  allows you to erase any changes made to the  current  line.  
  1791.         If  you type something and realize it was in the wrong  position, 
  1792.         pressing  Alt-R  will restore the line to its original  contents.  
  1793.         All changes are permanent once you move to another line however.
  1794.         The command works equally well in either Normal or Animator mode.
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.         TheDraw                                                 Page 26
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.                            Alt-S: Save Screen to Disk
  1854.  
  1855.  
  1856.         This command will save the entire screen to disk in ANSI,  ASCII, 
  1857.         ASM,  Binary,  Bsave,  or  Pascal formats.   Please note that all 
  1858.         color attributes are lost in an ASCII file.
  1859.  
  1860.         ASM produces a list of DB statements for use by assembly language 
  1861.         programmers.   Binary  is simply a straight dump of  the  screen.  
  1862.         Bsave  is  the same as binary except loading codes for Basic  are 
  1863.         added at the front.   A Pascal file is similar to the ASM output, 
  1864.         except  it is in a Turbo Pascal compatible 'const' statement (see 
  1865.         notes below for programming examples).  
  1866.  
  1867.         You are first prompted for which storage format to use.   If  you 
  1868.         select  ASCII,  you  are prompted if you really want a  non-color 
  1869.         image made before continuing.
  1870.  
  1871.         Selecting  ANSI  gives you a few more options (all of which  will 
  1872.         use defaults by pressing [Enter]).  
  1873.  
  1874.           You  are  first  asked  how  you  want  the  video  initially 
  1875.           prepared.  You can have the screen cleared, the cursor simply 
  1876.           homed (returned to upper-left corner of screen), or leave the 
  1877.           screen  as is.
  1878.  
  1879.           Secondly,  you  are  prompted  for the  maximum  output  line 
  1880.           length.   It  is conceivable that TheDraw could generate over 
  1881.           1300 characters for just one line of text (if every character 
  1882.           had  a differing color combination).   If for some reason  an 
  1883.           external  program  is  to be  used,  it's  doubtful  so  many 
  1884.           characters could be handled (ie: the message entry routine in 
  1885.           the RBBS Bulletin board).  This option tells TheDraw to limit 
  1886.           the output line length,  sacrificing display time (because of 
  1887.           all the extra codes which must be included).  If length is no 
  1888.           problem, specify [N]one to make the most efficient file.
  1889.  
  1890.           Lastly, you are prompted for the Ansi display speed.  This is 
  1891.           a  number  from 0 to 50,  and operates similar to  the  ALT-Q 
  1892.           animator function.  This works by adding harmless codes after 
  1893.           everything that is displayed.  A value of 50 is equivalent to 
  1894.           a ALT-Q speed of 255 (extremely slow).   
  1895.  
  1896.         Following the above you are prompted for a filename.  If the file 
  1897.         already   exists,  you  are  prompted to verify  the  save.   The 
  1898.         program  assumes the file extensions ".ANS" for  ANSI  compatible 
  1899.         files,  ".ASC" for ASCII text files,  ".ASM" for assembler files, 
  1900.         ".BIN" for binary dumps, ".BSV" for Bsave files, and ".PAS" for a 
  1901.         Pascal  file.   A file without an extension can be  specified  by 
  1902.         placing  a  period  as the last character of  the  filename  (ie: 
  1903.         TESTFILE. ).
  1904.  
  1905.         The  screen is then output to disk (assuming a valid filename was 
  1906.         entered).
  1907.  
  1908.  
  1909.         TheDraw                                                 Page 27
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.                        Alt-S: Save Screen to Disk (cont): 
  1920.  
  1921.  
  1922.         Notes:   
  1923.  
  1924.         Many people may find their need only requires, say, three or four 
  1925.         lines  of  text or only half the screen.   You can  have  TheDraw 
  1926.         output  a  mini-screen  by using the  block  action  save  screen 
  1927.         command  (see  Alt-B)  instead  of  this  option.   Block  action 
  1928.         commands allow a screen of any dimension from any position on the 
  1929.         screen to be saved.   BSave files have a restriction however,  in 
  1930.         that  they  must  be the screen width.   This is  restriction  of 
  1931.         Basic, not TheDraw. 
  1932.  
  1933.         For  suggestions on using the screen files created by TheDraw see 
  1934.         the section "Programmers Programming Tips" below.  
  1935.  
  1936.         Animation Notes:    Animation mode forces the use of ANSI output.  
  1937.         TheDraw simply bypasses the first prompt.   If you wish to output 
  1938.         just copies of what is currently on the screen,  you must convert 
  1939.         the screen to a normal file using the Alt-J command.
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.         TheDraw                                                 Page 28
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.                                 Alt-T: Tab Setup
  1986.  
  1987.  
  1988.         This command allows you to specify at what positions you want the 
  1989.         [TAB] key to stop at.  Initially the positions are at every tenth 
  1990.         column.   You  can  [S]et additional  ones,  [C]lear  a  setting, 
  1991.         [R]eset  the  tab line to the initial settings,  [E]rase all  tab 
  1992.         settings,  or  set  tab points at every  [I]ncremented  position.  
  1993.         With  the incremented option,  you are prompted for a step  size.  
  1994.         From  the  current position,  every nth location  is  set.   This 
  1995.         allows you to quickly specify,  say every fourth position if your 
  1996.         need requires it.  Press [ESC] to exit this mode.
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.         TheDraw                                                 Page 29
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.                          Alt-U: Use Colors under Cursor
  2052.  
  2053.  
  2054.         This  commands provides a convenient way of changing the  current 
  2055.         color attributes to those under the cursor. 
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.         TheDraw                                                 Page 30
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.                               Alt-V: View a Screen
  2118.  
  2119.  
  2120.         This  command  allows  you to look at  another  image  from  disk 
  2121.         without  erasing  the  current  one.    You  might  use  this  in 
  2122.         conjunction  with  the data import function in the  block  action 
  2123.         commands.  It  works  similar to the load screen command  (Alt-L)     
  2124.         except the image is not stored.
  2125.  
  2126.         This  command  can also use this to verify that a save  was  done 
  2127.         properly.   Simply  view the file after saving it.   If you  EVER 
  2128.         discover TheDraw did not do it right,  please send a little  card 
  2129.         describing the problem in detail.   If you're the first to report 
  2130.         a  particular error,  you'll be credited in the revision  history 
  2131.         below.  Thanks!     
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.         TheDraw                                                 Page 31
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.                               Alt-W: Edit Character
  2184.  
  2185.  
  2186.         This is an animator ONLY function.  Since overwrite doesn't exist 
  2187.         in  Animator  mode  (because anything typed over a  character  is 
  2188.         simply  added to the sequence),  a command for overwriting had to 
  2189.         be  added.   After pressing Alt-W you are prompted to type a  new 
  2190.         character.   ALL commands including arrow keys,  are  deactivated 
  2191.         except  for  the color attribute function (Alt-A) and  Ctrl-Arrow 
  2192.         keys. 
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.         TheDraw                                                 Page 32
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.                                Alt-X: Exit TheDraw
  2250.  
  2251.  
  2252.         This  should  be  obvious.   You are prompted  to  verify  before 
  2253.         leaving the program.
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.         TheDraw                                                 Page 33
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.                            Alt-Y: Delete Current Line
  2316.  
  2317.  
  2318.         Should be an obvious command.  Everything below the current  line 
  2319.         is shifted up one position. The bottom line is left cleared. This 
  2320.         command is not reversible, so use it carefully.
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.         TheDraw                                                 Page 34
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.                           Alt-Z: Erase Cursor Character
  2382.  
  2383.  
  2384.         This  is akin to typing a space in normal mode over something you 
  2385.         don't  want.   Alt-Z  erases  the  top-most  character  from  the 
  2386.         animation sequence at the current cursor position.
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.         TheDraw                                                 Page 35
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.                           Alt-= Toggle Macro Learn Mode
  2448.                      (available in registered version only) 
  2449.  
  2450.  
  2451.         This  function allows you to teach TheDraw a new macro  sequence.  
  2452.         You are prompted for which key to program (0-9),  and that's  it.  
  2453.         From this point on,  anything you type will be stored.   When you 
  2454.         are satisfied with what you've typed, using Alt-= again will save 
  2455.         the macro.   To use the macros just type Alt followed by a number 
  2456.         key  0 through 9 (NOT the ones on the keypad).   That's all there 
  2457.         is to macros.  Enjoy!
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.         TheDraw                                                 Page 36
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.               Ctrl-Up and Ctrl-Down Arrow: Foreground Color Change
  2514.  
  2515.  
  2516.         This  command  is  a  convenient way  of  adjusting  the  current 
  2517.         foreground color.  By pressing Ctrl-Up (increment color) or Ctrl-
  2518.         Down  (decrement  color)  and watching the word  "color"  at  the 
  2519.         bottom  of the screen,  you can select the color you  want.   You 
  2520.         might find this more useful than the Alt-A command.  
  2521.  
  2522.         Notes:   TheDraw  has a special keyboard driver program installed 
  2523.         to handle these keys.  If they aren't working on your machine run 
  2524.         the SETUP.COM utility and configure TheDraw to your keyboard.
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.         TheDraw                                                 Page 37
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.              Ctrl-Left and Ctrl-Right Arrow: Background Color Change 
  2580.  
  2581.  
  2582.         This  command  works  identically to the above option  except  it 
  2583.         changes  the  background color instead of  the  foreground.   Use 
  2584.         Ctrl-Right to increment the color and Ctrl-Left to decrement it.
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.         TheDraw                                                 Page 38
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.                        Shift-Space: Solid Space Character
  2646.  
  2647.  
  2648.         With the addition of moving blocks UNDER other objects,  the need 
  2649.         for a non-transparent space became apparent.   This command fills 
  2650.         the  need.   When  you move the cursor onto a  Solid  space,  the 
  2651.         current  background color will flicker as an indicator.   A Solid 
  2652.         space  is  nothing  more than the code #255  (which  is  a  blank 
  2653.         IBM graphics character).
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.         TheDraw                                                 Page 39
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.                           Programmers Programming Tips:
  2712.  
  2713.  
  2714.         This  section is for those people interested in using TheDraw for 
  2715.         their  programs.    Effort  was  put into TheDraw to  make  it  a 
  2716.         convenient utility.
  2717.  
  2718.         Assembler  programmers  will find the file in standard data  byte 
  2719.         format,  using  the DB operator.   All Asm files hold  4000  data 
  2720.         bytes unless you specified a block save.  Block saves indicate in 
  2721.         the  output  appropriate dimensions.    To put something  on  the 
  2722.         screen  you -can- use the REP MOVSW instruction to quickly  flash 
  2723.         on  the  image.   Point  the ES:DI pair to B800:0000  (for  color 
  2724.         screens)  and DS:SI to the screen in  your  program.   Monochrome 
  2725.         screens are based at segment B000.   This will cause snow on some 
  2726.         color videos however,  so you may want to move the screen a  word 
  2727.         at  a  time  only  when  the video  is  in  a  vertical  retrace.   
  2728.         Vertical  retrace  can be detected at I/O address 3DA by  testing 
  2729.         bit 3 of that location.
  2730.  
  2731.         Pascal  programmers have similar ease with bringing in a  screen.  
  2732.         You  can  also flash the image in a similar fashion  to  the  Asm 
  2733.         program  using  the  Move procedure.   Define a variable  at  the 
  2734.         absolute address of the screen.  ie:
  2735.  
  2736.               type ScreenType = array [0..3999] of Byte;  
  2737.               var  Screen : ScreenType absolute $B800:0000;
  2738.  
  2739.         The  importance  of  defining such an array will  become  obvious 
  2740.         below.  Next do a move similar to:
  2741.  
  2742.               Move (ScreenImage,Screen,4000);   
  2743.  
  2744.         Assuming ScreenImage is the name of the pascal image dump.   This 
  2745.         is only for a full screen.  To display a screen block is slightly 
  2746.         more difficult.   We must use a loop and move a line at a time in 
  2747.         this case.  ie:
  2748.  
  2749.         for X := 1 to Depth do
  2750.           Move (ScreenImage[(X-1)*Width*2],Screen[X*160+Offset],Width*2);
  2751.          
  2752.         Depth  is  the  number of lines in the block,  and width  is  the 
  2753.         number  of characters across the block.   This moves a line  from 
  2754.         ScreenImage  to the video at a given Offset one line at  a  time.  
  2755.         The  address  in ScreenImage is advanced to the location  of  the 
  2756.         next  line  in  each loop,  with the video  address  advance  160 
  2757.         characters each time (the true width of the video).
  2758.  
  2759.         Turbo Pascal users also have another interesting option.  You can 
  2760.         include  a  .BIN file into a turbo program and  then  display  it 
  2761.         using  the above techniques.   Define a dummy external  procedure 
  2762.         using the name of the .BIN file.   ie:
  2763.  
  2764.            procedure DummyProc; external 'DEMO.BIN'; begin end;
  2765.  
  2766.  
  2767.         TheDraw                                                 Page 40
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.                       Programmers Programming Tips (cont):
  2778.  
  2779.  
  2780.         This makes the binary file part of your pascal  program.    Next, 
  2781.         you must set a pointer variable to the address of that procedure.
  2782.         ie: (assuming DummyPtr : ^ScreenType);
  2783.           
  2784.           DummyPtr := Ptr(CSeg,Ofs(DummyProc));
  2785.  
  2786.         The  last part is simple.   All we have to do now is replace  all 
  2787.         references  in the above examples to ScreenImage with  DummyPtr^. 
  2788.         Don't forget the up arrow symbol at the end (otherwise you'll get 
  2789.         some interesting results).  ie:  
  2790.  
  2791.           Move (DummyPtr^,Screen,4000);
  2792.  
  2793.         It  can be fun to play around with this concept,  all you have to 
  2794.         do is be careful with the pointers.
  2795.  
  2796.  
  2797.         Basic programmers are a little more limited,  not because of lack 
  2798.         of commands,  but lack of speed.   Therefore TheDraw creates  the 
  2799.         BSave  files with all addressing information already  programmed.  
  2800.         All  you  have to do is type BLOAD  "filename.BSV".   The  screen 
  2801.         segment  is automatically set,  so you don't have to bother  with 
  2802.         DEF  SEG=etc...   TheDraw  allows partial block saves  for  basic 
  2803.         meaning  the  blocks  must  be 80 characters  wide.   This  is  a 
  2804.         limitation of BLOAD which we all must live with.   They can start 
  2805.         and end at any line however, so you could load a full screen then 
  2806.         just  load small block images to update those parts of the screen 
  2807.         needing  it.   Make  sure you build the partial-block  images  in 
  2808.         TheDraw  in  the exact screen location you want them  to  finally 
  2809.         appear.   If  you save a block starting on line 5,  and ending on 
  2810.         line 8 that's where it appears in Basic.
  2811.  
  2812.         If  you  figure  out any more ideas for  this  section,  or  have 
  2813.         suggestions for me to work on I'd be glad to hear about them!
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.         TheDraw                                                 Page 41
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.                          R E V I S I O N   H I S T O R Y
  2844.  
  2845.  
  2846.         05/01/86  -  Version 1.00
  2847.                      Program completed.  
  2848.  
  2849.         05/05/86  -  Version 1.01
  2850.                      Carl  Ehmann noticed a glitch in text creation  that 
  2851.                      caused highlighting and blinking attributes  changes 
  2852.                      to go unnoticed.  This has been corrected.
  2853.  
  2854.         06/05/86  -  Version 1.02
  2855.                      Steven  Mills discovered a bug in the  file  loading 
  2856.                      routine  that caused TheDraw to flag valid filenames 
  2857.                      as invalid.  It has been squashed.
  2858.                                                                     
  2859.                      Changed the program to not allow the user to enter a 
  2860.                      code #26 or code #27 into a text screen.  A code #26 
  2861.                      is the Dos end of file marker, and entering it means 
  2862.                      loss of all following text upon displaying the  file 
  2863.                      or  reloading it back into TheDraw.   A code #27  is 
  2864.                      the  ANSI driver signal character.  Supposedly  ANSI 
  2865.                      ignores  invalid sequences,  but allowing  the  code 
  2866.                      created  "false"  ANSI  codes which  caused  loading 
  2867.                      problems.
  2868.  
  2869.         07/31/86  -  Version 1.03 
  2870.                      Upon prompting from Carl Ehmann,  output line length 
  2871.                      limiting has been added.  This will facilitate other 
  2872.                      programs  which cannot load lines conceivably  going 
  2873.                      over 1300 characters (such as RBBS).    
  2874.                                      
  2875.                      Color  changes  can now be  accomplished  using  the 
  2876.                      Ctrl-Left and Right arrow keys to increment the fore 
  2877.                      and background colors respectively.
  2878.  
  2879.         08/15/86  -  Version 1.10  (later changed to v2.00) 
  2880.                      Changes in a big way.  New features include:
  2881.                        ANSI Animation, Line Drawing, Ruler, movement of
  2882.                        blocks UNDER other text and much more!!
  2883.                        
  2884.                      Quick  color  change keys have been expanded to  use 
  2885.                      the Ctrl-Up,  Down,  Left,  and Right keys in a more 
  2886.                      logical manner.
  2887.  
  2888.         09/13/86  -  Version 2.01
  2889.                      A  few more enhancements to TheDraw.   Pop-Up  help, 
  2890.                      and macros have been added to the registered version 
  2891.                      of the program.  Also a few aspects of the animation 
  2892.                      editor have been speeded up.
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.         TheDraw                                                 Page 42
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.                     R E V I S I O N   H I S T O R Y  (cont):
  2910.  
  2911.  
  2912.         09/19/86  -  Version 2.02
  2913.                      Fixed  a  slight bug which was  causing  TheDraw  to 
  2914.                      display   the  wrong  Help  Screen  (in   registered 
  2915.                      version).    Also,  the  registered  version  wasn't 
  2916.                      keeping  track of where its overlay was.
  2917.  
  2918.         09/27/86  -  Version 2.03
  2919.                      Carl Ehmann noticed yet another glitch (what would I 
  2920.                      do without him?).   The Ascii save routine was using 
  2921.                      ANSI  codes to advance the cursor to the next  line.  
  2922.  
  2923.         11/28/86  -  Version 2.04
  2924.                      Ray Buti discovered a oddity with the Pascal  screen 
  2925.                      save.  If you used a single quote "'" TheDraw didn't 
  2926.                      compensate  for  it.   Therefore when  Turbo  Pascal 
  2927.                      compiled  that  screen  it  complained.    Ray  also 
  2928.                      noticed  that characters under #32 were missing  the 
  2929.                      "#" required by Turbo.  These have both been cured.
  2930.  
  2931.                      In  addition,   the animation load routine has  been 
  2932.                      made  more  reliable.   Occasionally  movement  just 
  2933.                      involving the cursor (no text) would be lost.  Other 
  2934.                      improvements  were  made  to make  animation  screen 
  2935.                      files smaller and display faster.
  2936.  
  2937.         03/06/87  -  Version 2.10
  2938.                      Support  for  monochrome monitors has  finally  been 
  2939.                      added.   Don't ask why I never did it before...  The 
  2940.                      glitches  Paul Pacter (and many other people)  found 
  2941.                      with IBM PC Ctrl-Up/Down keys has been eliminated. I 
  2942.                      would  have  never  noticed  that  glitch,  so  many 
  2943.                      thanks!   Kent  Godding made an excellent suggestion 
  2944.                      for  a ansi-file slow down routine.   This has  been 
  2945.                      added.   Lastly,  a  few  changes were made  to  the 
  2946.                      command structure to clarify things and many prompts 
  2947.                      were cleaned up.
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.         TheDraw                                                 Page 43
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.                                T H E   F U T U R E
  2976.  
  2977.  
  2978.         Look for this feature and more in version 2.2 of TheDraw:
  2979.  
  2980.  
  2981.           Optional  Full Screen Editing (use all 25 lines)!   Ray Buti 
  2982.           has been giving subtle hints for ages.   I had thought about 
  2983.           this  before,  but didn't do anything because of  the  major 
  2984.           overhaul required...  Woe is me.  Look for it!
  2985.  
  2986.  
  2987.         Send  in your ideas,  suggestions,  criticisms and  bug  reports.  
  2988.         Report  something  first  and  be immortalized  in  the  docs  of 
  2989.         TheDraw!
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.         TheDraw                                                 Page 44
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.                              R E G I S T R A T I O N
  3042.  
  3043.         Registering  for  any TheSoft product (that OFFERS  a  registered 
  3044.         version)  is simple.  Just send a note or a title screen  printer 
  3045.         dump with your name,  address,  program version, and a check with 
  3046.         the  requested  amount (minimum).   You will  receive  your  copy 
  3047.         promptly, and will be notified of any future TheSoft products!
  3048.  
  3049.         What  you receive is a disk with the latest versions of both  the 
  3050.         Registered and Public Domain copies of that program and some demo 
  3051.         files (if applicable) all with documentation.
  3052.  
  3053.  
  3054.         NOTES:
  3055.  
  3056.         Users  who contributed to TheSoft -before- the registered version 
  3057.         of TheDraw was made available, can register by simple sending the 
  3058.         difference to make up the $10 (generally another $5).  Be SURE to 
  3059.         indicate your previous contribution somehow to avoid confusion. 
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.         TheDraw                                                 Page 45
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.                       D I S K   U P D A T E   S E R V I C E 
  3108.  
  3109.  
  3110.         Users  who have Registered may upgrade to the latest  version  of 
  3111.         TheDraw by sending in their TheDraw ORIGINAL DISK,  along with $5 
  3112.         (service  and handling) and a note explaining the wanted upgrade.  
  3113.         On  the note include your serial number (found on  the  diskette) 
  3114.         and the address you want the disk sent to.
  3115.  
  3116.           You must send the registered program diskette,  otherwise  I 
  3117.           reserve the right to refuse the update.
  3118.  
  3119.         The original disk must have the registered version of TheDraw  on 
  3120.         it.   The disk will be reformatted and the Master copied onto it.  
  3121.         Any disk in poor condition will be replaced by TheSoft.   If  the 
  3122.         serial  number  is missing or the diskette does not  contain  the 
  3123.         registered  version of TheDraw,  I reserve the right to deny  the 
  3124.         update (disk will be returned unchanged).
  3125.  
  3126.         There  is bound to be someone out there saying other people  give 
  3127.         free updates to their programs.   I agree,  they do.   They  also 
  3128.         charge  $50  or  more when you register (those  I've  seen).   If 
  3129.         somebody  sends me $50 for TheDraw,  I'll gladly send  them  free 
  3130.         updates.   If  somebody sends me $5000,  I'll gladly send them  a 
  3131.         computer to use the free updates on (kidding).
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.         TheDraw                                                 Page 46
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.                                  W A R R A N T Y
  3174.  
  3175.         TheDraw  is  provided AS IS without any  warranty,  expressed  or 
  3176.         implied.  This includes the fitfulness to a particular purpose or 
  3177.         application.   While we tried to be as thorough as possible while 
  3178.         debugging  TheDraw,  we  claim no responsibility for  any  losses 
  3179.         incurred alleged to be caused by use of the program.  If you have 
  3180.         a problem with TheDraw please feel free to write and describe the 
  3181.         situation.   
  3182.  
  3183.         To  those  people who have registered,  the physical diskette  is 
  3184.         warranted  against  defects  in materials and workmanship  for  a 
  3185.         period of 30 days from date of shipment (by TheSoft Programming).
  3186.         Any returned disks found bad will be replaced at no charge. 
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.         TheDraw                                                 Page 47
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.                                   L I C E N S E
  3240.          
  3241.         You are free to use,  copy, and distribute the PUBLICLY AVAILABLE 
  3242.         version of TheDraw to others so long as:
  3243.  
  3244.           1)   No fee is charged for its use.
  3245.  
  3246.           2)   No  fee  is charged for copying or distribution  over  the 
  3247.                amount  of $5 (plus any mailing charges).   This does  not 
  3248.                apply  to computer access charges the system operators  of 
  3249.                or  organizations owning  bulletin board  systems,  online 
  3250.                services, etc... may or may not charge subscribers.
  3251.  
  3252.           3)   It has not been modified in ANY way.
  3253.  
  3254.  
  3255.  
  3256.         The  REGISTERED  version  of  TheDraw may not  be  given  out  or 
  3257.         distributed.   Doing so deprives TheSoft Programming and besides, 
  3258.         is a violation of federal copyright laws.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.         TheDraw                                                 Page 48
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.                                  C O M M E N T S
  3306.  
  3307.         Please  consider the donation of $10 (or  any  amount).   Quality 
  3308.         software at good prices is difficult to find these days.   We  at 
  3309.         TheSoft  Programming  Services firmly believe in and support  the 
  3310.         concept of shareware products, and hopefully you do also.  Please 
  3311.         make any checks out to TheSoft Programming Services.  If you have 
  3312.         any requests,  comments or suggestions for TheDraw,  please  send 
  3313.         them to:
  3314.  
  3315.  
  3316.  
  3317.                           TheSoft Programming Services
  3318.                           c/o Ian Davis
  3319.                           1929 Whitecliff Court
  3320.                           Walnut Creek, Ca, 94596.
  3321.  
  3322.  
  3323.  
  3324.         Thanks for your support!
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.         TheDraw                                                 Page 49
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.